home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / catn / case.n < prev    next >
Text File  |  1994-09-20  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. case(n)               Tcl Built-In Commands                   7.0
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      case - Evaluate one of several scripts, depending on a given
  12.      value
  13.  
  14. SYNOPSIS
  15.      case _s_t_r_i_n_g ?in? _p_a_t_L_i_s_t _b_o_d_y ?_p_a_t_L_i_s_t _b_o_d_y ...?
  16.      case _s_t_r_i_n_g ?in? {_p_a_t_L_i_s_t _b_o_d_y ?_p_a_t_L_i_s_t _b_o_d_y ...?}
  17. _________________________________________________________________
  18.  
  19.  
  20. DESCRIPTION
  21.      _N_o_t_e: _t_h_e case _c_o_m_m_a_n_d _i_s _o_b_s_o_l_e_t_e _a_n_d _i_s _s_u_p_p_o_r_t_e_d _o_n_l_y _f_o_r
  22.      _b_a_c_k_w_a_r_d  _c_o_m_p_a_t_i_b_i_l_i_t_y.  _A_t _s_o_m_e _p_o_i_n_t _i_n _t_h_e _f_u_t_u_r_e _i_t _m_a_y
  23.      _b_e _r_e_m_o_v_e_d _e_n_t_i_r_e_l_y.  _Y_o_u  _s_h_o_u_l_d  _u_s_e  _t_h_e  switch  _c_o_m_m_a_n_d
  24.      _i_n_s_t_e_a_d.
  25.  
  26.      The case command matches _s_t_r_i_n_g against each of the  _p_a_t_L_i_s_t
  27.      arguments  in order.  Each _p_a_t_L_i_s_t argument is a list of one
  28.      or more patterns.  If any of these patterns  matches  _s_t_r_i_n_g
  29.      then  case  evaluates the following _b_o_d_y argument by passing
  30.      it recursively to the Tcl interpreter and returns the result
  31.      of  that  evaluation.   Each  _p_a_t_L_i_s_t argument consists of a
  32.      single pattern or list of patterns.  Each pattern  may  con-
  33.      tain any of the wild-cards described under string match.  If
  34.      a _p_a_t_L_i_s_t argument is default, the corresponding  body  will
  35.      be  evaluated  if  no _p_a_t_L_i_s_t matches _s_t_r_i_n_g.  If no _p_a_t_L_i_s_t
  36.      argument matches _s_t_r_i_n_g and no default is  given,  then  the
  37.      case command returns an empty string.
  38.  
  39.      Two syntaxes are provided for the  _p_a_t_L_i_s_t  and  _b_o_d_y  argu-
  40.      ments.   The  first uses a separate argument for each of the
  41.      patterns and commands; this form is convenient if  substitu-
  42.      tions  are desired on some of the patterns or commands.  The
  43.      second form places all of the patterns and commands together
  44.      into  a  single argument; the argument must have proper list
  45.      structure, with the elements of the list being the  patterns
  46.      and  commands.   The  second form makes it easy to construct
  47.      multi-line case commands, since the braces around the  whole
  48.      list  make  it unnecessary to include a backslash at the end
  49.      of each line.  Since the _p_a_t_L_i_s_t arguments are in braces  in
  50.      the  second  form,  no command or variable substitutions are
  51.      performed on them;  this makes the behavior  of  the  second
  52.      form different than the first form in some cases.
  53.  
  54.  
  55. KEYWORDS
  56.      case, match, regular expression
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.